home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 2 / ETO Development Tools 2.iso / Tools - Objects / Virtual User 1.0b5 / Example Libraries / Read me First!!! < prev    next >
Encoding:
Text File  |  1990-10-05  |  3.4 KB  |  75 lines  |  [TEXT/MPS ]
  1. This folder contains useful VU task libraries which you might want to 
  2. make use of in your scripts.
  3.  
  4. The files and brief descriptions of their contents follows:
  5.  
  6. 1. StringsLib.vu
  7.     Contains:    Task defintions to convert numbers into strings and strings into numbers.
  8.     
  9.     The main tasks are:
  10.     a)    task NumToStr(number) 
  11.     This task takes in a number and converts it into a string. If the argument 
  12.     passed in is not a number undefined is returned.
  13.  
  14.     b) task StrToNum(str, start_index := 1, end_index := -1) 
  15.     This task takes in a string and converts it into an integer, if possible.
  16.     You can pass a start and end indices into a string in which a number is 
  17.     embedded. This task deals with both positive and negative numbers.
  18.     It returns MaxNum (32767) or MinNum (-32767) in error(overflow) conditions.
  19.     It deals with cases such as "+123" and "-462" as well as unsigned ones like "981".
  20.     If the argument passed in is not a string undefined is returned.
  21.         
  22.  
  23.  
  24. 2. FinderOperationsLib.vu -
  25.     Contains: Tasks that help do some simple Finder operations like selecting a file in
  26.               a window or trashing it.
  27.     
  28.     a) task Find_object_in_window (at_x, at_y)
  29.         This task moves the mouse on to a particular object of interest. Very useful to select
  30.         files in "View By Name" mode in Finder.
  31.     b) task throw_trash(print_any_error := true, override_alerts := false)
  32.         This task trashes a specified object in Finder. The argument 'print_any_error'
  33.         can be used to suppress the error messages printed by this task. 
  34.         'override_alerts' can be used to trash despite alerts (it selects the 'OK' button)
  35.         if this argument is true (or non null).
  36.  
  37.  
  38. 3. StandardDialogsLib.vu -    
  39.     Contains:    Sample tasks for working with standard Macintosh dialogs
  40.     The tasks in this file are:
  41.     
  42.     a) do_save_as( save_title := 'Untitled' ) : 
  43.        This task handles a simple case of saving a file with the Standard File dialog.
  44.     b) select_from_standard_file(path_to_file,maximum_nesting_depth := 64) :
  45.        This task will select a file from the standard file dialog.
  46.        It navigates through the dialog by way of the keyboard.
  47.        It takes two parameters, one is a list of file prefixes that will take
  48.        the virtual user down to the file you want selected. The list must 
  49.        contain the strings that VU can type to reach the file.  They may be the
  50.        complete folder names or enough of the folder name to distinguish them 
  51.        from sibling folders.  The second is a number indicating the current 
  52.        directory's maximum depth.  VU uses this number to get up to the top using
  53.        command-up arrow.  By default, it is 64 so it isn't necessary to pass
  54.        the second parameter.  The operation may be made faster, however, if you
  55.        pass it a smaller number.  A sample call might look like this:
  56.         select_from_standard_file( { "HD","MPW","Interf","Cinclu","Palettes" },10 );
  57.  
  58.  
  59. 4. TimeLib.vu -
  60.     Contains:    Tasks that make it easier to work with time in VU.
  61.     
  62.   a) task wait_for_time( end_hour := 0, end_minute := 0, end_second := 0 ) :
  63.      This task will wait until a specified time of day.
  64.     
  65.   b) task print_current_time(print_date := true) :
  66.     This task pretty prints the current time.  The format is as follows:
  67.         <hour of day>:<minutes>:<seconds> <AM or PM>
  68.     It also takes one parameter that indicates whether the date should be printed.
  69.     If the actual parameter passed is a true value, the current date is also printed.
  70.     If no parameter is passed, the date is printed by default.
  71.     The format of the date is as follows:
  72.         <month>/<day>/<year>    
  73.  
  74.  
  75.